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POST II Trajectory Animation Tool Using MATLAB, V1.0 

1 Introduction 

Typically the output from trajectory simulation programs is analyzed using two-dimensional time 
history plots. It is often desired to animate the trajectory where position and orientation of the bodies in 
flight are put into motion. The following is a MATLAB based tool which generates a movie from the 
trajectory data. The animations generated using this tool serve as an engineering analysis tool to gain 
further insight into the dynamic behavior of flight vehicles. This tool is able to animate a single body as 
well as multiple vehicles in flight, and has been tailored for output generated from POST II simulations. 

2 Method 

This tool has been designed such that no code modification is required by the user. The animation 
tool obtains most of the required inputs from the POST II input file, POST II output file, and the Matfile 
(Figure 1). The user is required to provide master_setup.txt, geom_data and camera_properties.txt 
files for additional parameters. 



Figure 1 Animation tool flow diagram 
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Step-by-step instructions 

This section outlines, step-by-step, the procedure to make a trajectory animation. The animation 
tool has been developed in MATLAB. All the source files have been compiled using the MATLAB 
Compiler. The compiled executable, named animation_driver.exe, is a stand-alone application and is 
used to generate trajectory animations in AVI format. The AVI file is compatible with both PCs and 
Macs. 


3.1 Step 1: Installation 

MATLAB Component Runtime (MCR) module needs to be installed on the host machine. A 
MATLAB license is not required for the MCR installation. The MCR installer utility program 
(MCRInstaller.exe) will be provided as part with the animation tool. The MATLAB Component 
Runtime installation procedure is provided in MATLAB Compiler User’s Guide [2], page 4-6. It is also 
available on the web. The instructions are provided for the Windows and Linux platforms. 

http://www.mathworks.com/access/helpdesk/help/toolbox/compiler/999353 


3.1.1 Windows installation 

The following components make up the animation application on Windows platforms. 

MCRlnstaller . exe Self-extracting MATLAB Component Runtime library utility; 

Platform-dependent file that must correspond to the end user’s 
platform. 

animation_driver . exe Animation application 

animation_driver . ctf Component Technology File archive; Platform-dependent file 

that must correspond to the end user’s platform. 

Copy animation_driver.exe and animation_driver.ctf files to the local drive in the same 
directory as the trajectory data. The animation program is provoked by double-clicking on the 
animation_driver.exe file. 

3.1.2 Linux installation 

For the Linux operating system, the following components will be provided. 

MCRlnstaller . zip Self-extracting MATLAB Component Runtime library archive; 

Platform-dependent file that must correspond to the end user’s 
platform. 

unzip Utility to unzip MCRInstaller.zip (optional). The target 

machine must have an unzip utility installed. 

animation_driver Animation application 

animation_driver . ctf Component Technology File archive; Platform-dependent file 

that must correspond to the end user’s platform. 


3.2 Step 2: Set up local directory 

The user needs to set up a local directory containing all the case specific files, such as the POST 
II input file, output file, Matfile, and other setup files. These files contain mission specific data such as the 
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trajectory, movie setup (frame rate, frame size, background color, lighting, etc), and links to where the 
geometries for the vehicles are stored. The following is a listing of local files: 

POSTfile.inp 

POSTf ile . out 

POSTf ile .mat 

master setup inputs.txt 

camera_properties . txt 

geom_data 

Samples of these files can be found in the following directory: 

/usr/people/v3u2/vab/rais/animation local dir 

3.3 Step 3: POST II trajectory data 

The POST II input file, output file, and the Matfile need to be copied to the local directory where 
they are processed and prepared for animation. 

3.3.1 POST II Input file 

Some parameters are extracted from the POST II input file. This includes planet rotation rate, 
mass of each vehicle, vehicles activation/deactivation, event sequencing, line activation/deactivation, line 
attach point locations, etc. The input parser also looks through all the included files to gather information. 
The user needs to make sure the path to the included files remains accurate if the input file and the include 
files are copied from their original directory. If the input file contains a “* milestone read” statement, it 
should be replaced by “* include milecreate_fname.inp”, where “milecreate_fname.inp” is the input 
file that created the binary milestone. 

3.3.1 POST II Matfile 

The animation tool expects the following variables in the POST II Matfile for each active vehicle. 
Make sure they are included in the profile. For POST II variable definitions see Reference 1 . The burden 
of choosing a proper time interval between the data points is placed on the user. Choosing a proper time 
interval is a function of the desired movie frame rate and the apparent speed of the movie. See section 3.4 
for further discussion. 

time - trajectory time 
longi - inertial longitude 
decln - declination 

ib matrix - inertial to body direction cosine matrix (9 elements) 

xi, yi, zi - cartesian coordinates of the vehicle CM in inertial frame 

gammar - planet relative flight path angle 

azvelr - azimuth of the planet relative velocity vector 

xcg, ycg, zcg - location of eg with respect to the BR frame 

3.3.3 POST II output file 

The event numbers were obtained from the POST II input file, and the corresponding event times 
are extracted from the POST II output file. 
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3.4 Step 4: Setting up master_setup.txt 

Next, the user needs to fill in appropriate data for the master_setup.txt input file. This file lets 
the user specify data that is global in nature, such as the background color, number of movie frames per 
second, lighting parameters, movie name, and link to of various input files. The variable names are 
descriptive for convenience. All colors are input as three integers representing the Red, Green, and Blue 
(RGB) intensities ranging from 0 to 255. The entries in bold are required entries, and the entries in italic 
are informational and will be displayed with a dial or as a bar graph. Display of informational parameters 
is completely optional. Other parameters in plain font are required parameters but will default to the 
values listed below if the user does not provide input. 


post_input file 

= 

cl animation . inp 


II 

mandatory entry 

post_output_f ile 

= 

cl animation . out 


II 

mandatory entry 

post_matf ile 

= 

cl animation 25fps 

.mat // 

mandatory entry 

movie name 

= 

mera 

take2 . 

avi 


II 

default output.avi if not input 

frames_per_second 

= 

25 




II 

mandatory entry 

projection 

= 

perspective 



II 

other option: orthographic 

num pixels horizontal 

= 

600 




II 

movies always 3X2 aspect ratio 

light color ( 1 ) 

= 

255 

255 

255 


II 

by default, only one light source 

light color (2 ) 

= 

210 

210 

160 


II 

additional optional light source 

light position ned(l) 

= 

0 

0 - 

500 


II 

default position of light 1 

light position ned(2) 

= 

-4 

30 - 

100 


II 

position of additional light 

background color 

= 

0 

0 

0 


II 

background black by default 

gauge color 

= 

150 

150 

150 


II 

all gauges in gray by default 

starting index 

= 

1 



// 

starting index defaulted to 1 

ending index 

= 

3516 



// 

defaulted to the length of trajectory 

step 

= 

1 



// 

use 

higher numbers to reduce run time 

altimeter var 

= 

gdal t 




// 

altitude up to 100 km 

radar altimeter var 

= 

hgtagl 



// 

altitude up to 500 m 

G meter var 

= 

asmg 




// 

acceleration in Earth Gs 

mach meter var 

= 

mach 




// 

mach meter 

airspeed var 

= 

velr 




// 

airspeed gauge 

horiz vel var 

= 

N vel 

E vel 



// 

horizontal velocity gauge 

fuel gaguge var 

= 

wprop 



// 

fuel usage 

fuel capacity 

= 

234 




// 

amount of fuel when full 

altimeter assigned spot 


= 5 



// 

default altimeter spot 

radar altimeter assigned , 

spot 

= 6 



// 

default radar altimeter spot 

G meter assigned spot 



= 7 



// 

default G meter spot 

mach meter assigned spot 


= 8 



// 

default mach meter spot 

airspeed assigned spot 


= 9 



// 

default airspeed gauge spot 

horiz vel assigned spot 


= 10 



// 

default horizontal vel gauge spot 

fuel gaguge assigned 

spot 


= 11 



// 

default fuel usage spot 

display post variable 

name (1) 

= 

gamma r 

1 

// 

displayed as a bar graph 

display post variable 

name (2) 

= 

velr 1 


// 

displayed as a bar graph 

display post variable 

put 

right (1) = 

1 


// 

displayed on the right side 

Ambient Strength 


= 0.4 






DiffuseStrength 


= 0.6 






Specular Strength 


= 1.1 






SpecularColorReflectance ; 

= 1.0 






| SpecularExponent 


= 20 







animation_setup.txt listing 
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The frames_per_seconds parameter specifies the number of frames that are combined to make 
one second of animation. If the reciprocal of this parameter is equal to the time interval provided by the 
Matfile, then the movie will appear to be in real time. Other combinations of frame rate and output time 
increment can be used to simulate slow motion or fast-forwarding effects. For example, if 
frames_per_seconds = 20 and Matfile time interval is 0.1, the movie will appear to be twice the 
normal speed. The recommended values for frames_per_seconds are 20 and 25. The movie will be 
choppy for small frame rates around 10, and the monitor displays cannot keep up with frame rate of 50 
and higher. 

Startingjndex, ending index and step specify a subset of the trajectory to be animated. If left 
out, startingjndex will default to one, endingjndex will default to the length of the trajectory, and 
step equals one. By default, the entire trajectory is animated. 

Display_post_variable_name(n) = ‘POST variable’ fields are optional. The POST II variables 
specified in this field are displayed on the bottom of the screen as moving bar graphs. The variable names 
need to be exactly as they appear in the POST II Matfile. By default, the bar graphs move horizontally 
from left to right when increasing in value. Bars graphs are stacked from bottom to top if more that one is 
requested. If desired, the bar graphs can be displayed on the right of the screen. This is accomplished by 
exercising the display_post_variable_put_right(n) = 1 option. 

The animation tool supports the display of some parameters by dials and gauges. The following 
parameters are available for dial display: time, net velocity, horizontal velocity, acceleration in Gs, mach 
number, altitude up to 100 km, altitude up to 500 m, spent fuel. Dials and gauges are automatically 
assigned a spot on the screen, but the spot assignment can be overridden by the user in the 
animation_setup.txt file. Figure 2 shows the default dial and gauge spot assignments. 



Figure 2 Default gauge locations 
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Figure 3 is an example of all the gauges being used on a Mars entry animation. All the gauges are 
placed in their default location in this example. 
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3.5 Step 5: Setting up geomdata 

The geom_data text file is responsible for setting up the geometrical representation of vehicles 
in flight. The syntax of geom_data is similar to the POST II input deck. Vehicle geometries are input at 
the start of POST II events. The animation tool expects a geometry input for each vehicle when first 
activated. Geometry input for an existing vehicle overwrites the previous input. Overwriting previous 
geometry can be used to reflect vehicle appearance changes such as jettisoning of spent stages, heatshield 
separation, parachute deployment, etc. The geom_data file is integrated into other animation inputs by 
adding the following line to the end POST II input file: * include geom_data . The animation tool 
processes this file along with other POST II included file. 


event 

= 1 





vehicle 

= 1 





veh geom file 

= patch 

data/ capsule 

/ 

relative path to vehicle 

geometry 

incl eg calc 

= 1 


/ 

include in composite eg 

calculation 

incl body axes 

= 1 


/ 

display body axes 


eng scale 

i 

= 112 

2 

/ 

scaling of rocket engine 

plumes 

G 

event 

= 45 





vehicle 

= 2 





* declare Rc 4.2215 





veh geom file 

= patch 

data/mer parachute 

/ 

relative path to vehicle 

geometry 

incl eg calc 

= 1 


/ 

include in composite eg 

calculation 

incl body axes 

= 1 


/ 

display body axes 


eng scale (2 ) 

= 3 


/ 

scale rocket engine 2 by 

factor of 3 


geom data sample 


The geometry is input as a collection of MATLAB patch elements. For more information on 
patches refer to MATLAB graphics manual. Patches are ideal for visualizing 3D objects such as 
aerospace vehicles and spacecrafts of arbitrary shapes. The vertices for the patches must be input in POST 
II Body Reference (BR) frame. The animation tool makes appropriate transformations to shift the 
geometrical representation of the vehicles to a planet relative coordinate system. The animation tool loads 
the geometrical data file specified on the right hand side of the veh_geom_file entry above. The file that 
is loaded contains an array of structures stored in geom_data with each element of the array making up a 
part. Each element of the geom_data array contains the coordinates of the vertices, polygons and color 
information. Color can be input in two ways. The first method is to specify a uniform color for a part 
using geom_data(n). color = [R G B] option. MATLAB also accommodates for each facet of the 
geometry to have its own color. This is accomplished by providing an additional color_array matrix of 
data in geom_data structure .The number of entries in color_array field must correspond to the number 
of entries in the faces, with each entry being the RGB intensity. The wireframe model of the Mars 
Exploration Rover entry capsule shown in Figure 4 contains 1152 vertices, and 1104 polygons all having 
the same color. 

geom_data(l) .vertO: [1152x3 double] 

geom_data(l) .faces: [1104x4 double] 

geom_data ( 1 ). color : [226 204 190] 
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Figure 4 MER entry capsule model 


Camera position and target are specified with respect to the composite vehicle center of mass. For 
a single vehicle in flight, composite vehicle center of mass is the same as the vehicle center of mass, but 
for multiple vehicle trajectory simulation, the composite vehicle center of mass is calculated at each time 
step. The user can exclude a vehicle from composite center of mass calculation by setting the 

incl eg calc flag to zero in the geom_data file. This is useful when a body is being jettisoned, where 

the desired focus of the camera is the main vehicle, not the jettisoned body. 


3.6 Step 6: Setting up camera_properties.txt 

The camera special effects are accomplished by manipulating the camera_properties.txt file. 
This file contains the camera position and camera target with respect to the composite vehicle center of 
mass as a function of time. The camera generally moves through space along with the vehicle. The user 
specifies where the camera is located with respect to the composite vehicle center of mass. The camera 
position and target points are input in the geographic frame or in the relative velocity frame. North, east, 
and down directions form the Cartesian X, Y, and Z axes in the geographic frame. In the velocity frame, 
X-axis is in direction of the relative velocity vector; Y -axis is in the local horizontal plane, and Z-axis 
completes the right-handed coordinate system. The camera viewing angle is also input in 
camera_properties.txt file. The camera viewing angle can be used to simulate the effect of zooming in 
and out. All the properties are input as a function of trajectory time. The animation tool linearly 
interpolates in between discreet time intervals, so all camera movements appear smooth. The following is 
sample of the camera_properties.txt file: 


% Variables: 
% CVA 
% posi_cs 


% camera_position 
% targ_cs 


% camera_target 
% CFT 


Camera viwing angle 

camera position coordinate system 

ned -> Cameral location defined in NED frame with respect to composite CG 
fix -> Camera location stays fixed in ECR frame 
vel -> Camera location defined in relative velocity frame 
Camera position, if posi_cs = fix camera_position is in NED frame 
Camera target coordinate system 

ned -> Camera target defined in NED frame with respect to composite CG 
fix -> Camera target stays fixed in ECR frame 
vel -> Camera target defined in relative velocity frame 
Camera target coordinates in targ_cs coordinate system 
Camera fixed time. Used only when posi_cs or targ_cs = fix 


% time 

CVA 

posi cs 

<- camera position -> 

targ cs 

<- camera 

target 

-> 

CFT 

0.000 

45 

ned 

0.0 

-5.0 

-20.0 

ned 

0.0 

0.0 

0.0 

0.0 

300.000 

45 

ned 

0.0 

-5.0 

-20.0 

ned 

0.0 

0.0 

0.0 

0.0 

320.000 

45 

ned 

-50.0 

0.0 

-15.0 

ned 

0.0 

0.0 

0.0 

0.0 

1135.000 

45 

vel 

-10.0 

10.0 

0.0 

vel 

0.0 

0.0 

0.0 

0.0 

1140.000 

45 

vel 

-50.0 

10.0 

0.0 

vel 

0.0 

0.0 

0.0 

0.0 

1143.000 

45 

vel 

-50.0 

10.0 

0.0 

vel 

0.0 

0.0 

0.0 

0.0 

1144.000 

10 

vel 

-50.0 

10.0 

0.0 

vel 

0.0 

0.0 

0.0 

0.0 

1149.000 

10 

vel 

-50.0 

10.0 

0.0 

vel 

0.0 

0.0 

0.0 

0.0 

1150.000 

45 

vel 

15.0 

10.0 

0.0 

vel 

0.0 

0.0 

0.0 

0.0 

1155.000 

45 

vel 

15.0 

10.0 

0.0 

vel 

0.0 

0.0 

0.0 

0.0 

1157.000 

45 

vel 

-50.0 

0.0 

0.0 

vel 

0.0 

0.0 

0.0 

0.0 

1170.000 

45 

vel 

-50.0 

0.0 

0.0 

vel 

0.0 

0.0 

0.0 

0.0 

1171.000 

40 

ned 

-50.0 

0.0 

-30.0 

vel 

-10.0 

0.0 

0.0 

0.0 

1177.000 

40 

ned 

-50.0 

0.0 

-30.0 

vel 

-17.0 

0.0 

0.0 

0.0 

1178.000 

40 

ned 

-70.0 

0.0 

20.0 

vel 

-17.0 

0.0 

0.0 

0.0 

1185.000 

40 

ned 

-70.0 

0.0 

20.0 

vel 

-17.0 

0.0 

0.0 

0.0 

1186.000 

5 

fix 

-20.0 

0.0 

0.0 

vel 

-17.0 

0.0 

0.0 

1192.0 

1205.000 

5 

fix 

-20.0 

0.0 

0.0 

vel 

-17.0 

0.0 

0.0 

1192.0 

1206.000 

27 

ned 

-70.0 

0.0 

-90.0 

vel 

-25.0 

0.0 

0.0 

0.0 

2000.000 

27 

ned 

-70.0 

0.0 

-90.0 

vel 

-25.0 

0.0 

0.0 

0.0 


Sample camera_properties.txt file 


In the camera position options above, the camera location and target points are defined with 
respect to the composite center of mass. The animation tool also supports a fixed option for the camera 
where either the camera location or camera target or both remain fixed in space. This feature is activated 
by specifying the “fix” option in the camera_position and/or camera_target coordinate system flag. 
When this option is chosen, the system also looks up the Camera Fixed Time (CFT) field in the table. The 
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CFT field is the time when the vehicle position is looked up as the fixed location for the camera. This 
option simulates the effects of the vehicle flying past the camera, with the camera tracking. Setting the 
position and target coordinate systems to fix (columns 3 and 7) simulates the effects of a completely 
stationary camera. 

3.7 Step 7: Run animationdriver 

The animation tool is now ready to build all the data structures for generation of the movie. 
Double-click on the animation_driver executable to initiate the program. The animation_driver 
executable opens a DOS window and goes through the POST II input files, master_setup.txt, 
geom_data, camera_properties.txt, POST II output file, and the POST II Matfile to build up 
appropriate data structures. The movies are made in AVI format, and are compressed using Cinepak 
codec on the PCs. Figure 5 is a sample frame taken from one of the Mars entry animations. 



Figure 5 A sample frame from Mars entry simulation 
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